home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM A / PD-ROM A.iso / Utility / cdevs and INITs / FCBins / FCB Inspector Docs < prev   
Encoding:
Text File  |  1991-12-27  |  6.1 KB  |  104 lines  |  [TEXT/ttxt]
  1. FCB Inspector 1.01 is a freeware Control Panel that allows users to peek at a 
  2. Macintosh’s list of open files. It also provides information about these files on demand and can 
  3. close ones that aren’t crucial to system operation. Finally, it allows the maximum number of 
  4. open files to be changed.
  5.  
  6. To install it under System 6.0x, drag the FCB Inspector file icon into your System Folder 
  7. and reboot. 
  8.  
  9. To install it under System Software 7.0, drag the FCB Inspector file icon over the System 
  10. Folder icon and click OK to the dialog or drag it directly into the Control Panels folder and 
  11. reboot. FCB Inspector provides balloon help in system 7.
  12.  
  13. When FCB Inspector is opened, it immediately produces a list, located in the upper right 
  14. pane, of all the currently open files (including itself) indicated by each’s file name. It 
  15. continually checks for changes about which files are open and updates the list accordingly. 
  16. Generally, the list is updated almost immediately after a change occurs. The information is 
  17. gleaned directly (The Macintosh routine PBGetFCBInfo is not used because it skips certain files 
  18. and would thus produce an incomplete list) from the Macintosh’s own internal list of open files 
  19. known as the File Control Block Buffer, and each entry is called a File Control Block or FCB for 
  20. short. Usually, the files appear in the list in the order that they were opened. An unnamed file 
  21. is simply called “Unnamed File”. One of these unnamed files is the file containing a volume’s 
  22. extents, which refers to information about the location of files on a volume, and the other is a 
  23. file containing a volume’s catalog, which refers to information about the hierarchy of folders 
  24. on a volume.
  25.  
  26. To find out more about a particular open file, click on its name in the list or use the arrow 
  27. keys to select it. FCB Inspector displays most of the information available in the Macintosh’s 
  28. FCB list. Here’s a breakdown of this information field by field:
  29.  
  30. ioVRefNum — volume reference number. A number that can be used to access information 
  31. about the volume it specifies.
  32.  
  33. ioRefNum — file reference number. A number that can be used to access information about 
  34. the file it specifies. It is actually just an offset into the FCB buffer.
  35.  
  36. ioFCBFlNm — file number. Apparently not used, this number is not related to file ID’s in 
  37. System 7.
  38.  
  39. ioFCBFlags — a flag byte describing some characteristics of the file. It is indicated in FCB 
  40. Inspector with abbreviations: rd meaning read-only access, rdwr meaning read-write 
  41. access; data meaning data fork open, res meaning resource fork open (files are divided into two 
  42. forks or parts; generally, document files contain their data in data forks and have no resource 
  43. forks whereas programs contain code and related material exclusively in their resource fork 
  44. but have no data fork. Each open fork is a separate entry in the FCB); noMod meaning file (in the 
  45. volume buffer) hasn’t been changed since last write, and mod meaning file has been modified 
  46. since last write.
  47.  
  48. ioFCBStBlk — first allocation block (space is managed in terms of allocation blocks, which 
  49. are multiples of logical blocks. A logical block is 512 bytes) of file. Though, this field does not 
  50. specify the actual value.
  51.  
  52. ioFCBEOF — logical end of file. That is, the last byte in the file that contains data plus one 
  53. (because the bytes are numbered from zero). This is the same as the size of the file.
  54.  
  55. ioFCBPLen — physical end of file. That is, the last byte in the file’s last allocation block plus 
  56. one (because the bytes are numbered from zero).
  57.  
  58. ioFCBCrPs — current position or mark. The byte where the next read or write operation on 
  59. the file will take place.
  60.  
  61. ioFCBClpSiz — file’s clump size. The number of bytes (a multiple of the allocation block 
  62. size) allocated when Allocate is called or end-of-file is reached during a Write routine.
  63.  
  64. ioFCBParID — parent directory ID. The directory ID of the folder that contains the file.
  65.  
  66. ioFCBFType — file type. A four-character constant indicating the file’s type, such as 
  67. “APPL” for application, and “cdev” for Control Panel.
  68.  
  69. To close a file in the list, select it and click the “Close” button. For files that are crucial to 
  70. system operation such as the System file, the button is dimmed, and it is not possible to close 
  71. them. This does not mean that just because the button is not dim, it is safe to close a file, and 
  72. for that reason, it is necessary to click the button. Typing return or enter or double-clicking 
  73. the filename has no effect. Mostly, the files you want to close are ones opened by a program 
  74. you are developing and running. Be sure, however, that once you close a file in FCB Inspector 
  75. that you don’t close it in your own code.
  76.  
  77. FCB Inspector displays and can alter the maximum number of open files allowed. Contrary 
  78. to the description in Inside Macintosh IV and other sources, the information in the boot blocks 
  79. isn’t used. The number is derived by first dividing the total length of the FCB buffer, stored in 
  80. the first word in the buffer, by the size of a single FCB, stored in the word pointed to by 
  81. FSFCBLen, which is 94 bytes.  Then two is subtracted from the result to eliminate size of the 
  82. length word at the beginning of the buffer. The default number of open files is 40. To change this 
  83. number, click and hold the arrow button in the second pane on the left of the FCB Inspector 
  84. display until the desired number is reached in the “New Max” button. The minimum allowed is 
  85. 10 and the maximum is 120. Finally, click the button, which dims to indicate that this new 
  86. setting is now the one currently in effect. The change, which involves altering of the total 
  87. length word of the FCB buffer and the size of the buffer accordingly, actually occurs at startup. 
  88. Since the change occurs in memory only, FCB Inspector must be loaded at every startup that 
  89. you wish the maximum number of open files to be altered.
  90.  
  91. To disable FCB Inspector from loading at startup hold down the shift key in system 6.0x 
  92. and the tab key in system 7.0.
  93.  
  94. Distribution of FCB Inspector must be accompanied with this documentation.
  95.  
  96. FCB Inspector comes from 
  97.  
  98. Maurice Volaski
  99.  
  100. Internet: volaski@contra.med.buffalo.edu
  101.  
  102. Address: 173 Princeton Ave. Apt #2, Amherst, NY 14226-5006
  103.  
  104.